docs(native-surfaces): record 2.1.284 overlap verdicts and Boundary sections - #5387

…earning

Main now carries the squash merges of #5371 and #5387. Their files take
main's final form; this branch re-applies only its own hunks on top.

- overlap.py: the extracted build_native_index keeps main's plugin-backed
  reclassification; detect and dismiss both call it.
- test_overlap.py: main's PluginBackedSurfaceTests kept beside the
  dismissal tests.
- records.json: main's 47 rows plus this branch's 11 rows and 58
  dismissals. Two component fingerprints recomputed where main changed
  the description (architecture:map-context, claude-ops:audit-install-state);
  docs/native-surfaces.md regenerated.
- Versions above main: claude-ops 0.67.0, claude-config 0.53.2,
  source-control 0.62.29, native-references 3.2.2.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

…e every candidate (#5466)

No related issue: operator decisions Q8, Q9 and Q12 from the 2026-09-29
native-surfaces interview (follow-up to #5387).

## Summary

Overlap discovery re-proposed the same false positives on every run,
because a ruling of "not an overlap" had nowhere to live. About 59% of
candidates were noise. 69 discovered candidates were also still unruled,
and the new inventory and detect behavior had no evals.

Stacked on #5387, which is stacked on #5371.

## Fix

- **Dismissals (Q8):**
- The store gains an optional `dismissals` list. Each entry records the
native surface, the component, a reason, `as_of` and date, plus a
fingerprint of each side's whitespace-collapsed description.
- New `overlap.py dismiss` subcommand. It refuses a pair that already
has a verdict row.
- `detect` suppresses a dismissed pair until either fingerprint changes,
then resurfaces it flagged `resurfaced: description changed`. A verdict
row always wins.
- `self-check` validates dismissals, and `generate` renders a Dismissed
table.
- **Triage (Q9):** all 69 remaining candidates are ruled.
- 11 verdict rows, 8 of them non-defer, each with a Boundary section, or
a registry row only for agents.
  - 58 dismissals.
  - Fresh detect: 0 new candidates, 58 suppressed, 0 resurfaced.
- Every reason ends "Ruled 2026-09-29 by operator direction on the
orchestrator's recommendation."
- **Evals (Q12):**
- inventory: `is-foo-real-under-a-degraded-lane`,
`docs-crosscheck-classifies-a-removed-command`
- audit-native-overlap: `user-only-native-recommends-suggest`,
`dismissed-pair-suppressed-then-resurfaced`
- **Version bumps:** claude-ops, source-control, bugs, github,
claude-memory, claude-config, each with a CHANGELOG entry.

## Verification

- `overlap.py generate --check`: in sync (58 rows, 58 dismissals).
- `overlap.py self-check`: degraded on the 2 documented advisories only.
- `test_overlap.py`: 156 tests OK (22 new). `overlap.test.sh`: exit 0.
`test_inventory.py`: 101 tests OK.
- Eval files validate against
`plugins/skill-quality/reference/evals.schema.json`, and
`check-evals-quality.sh` passes with 0 warnings. No model evals were
run.
- `check-changed-skills.sh main`: 25 skills, 0 failed.
- `check-changelog-parity.sh`: `--check`, `--check-order` and
`--check-preserved origin/main` pass. `--check-bump origin/main` is red
only on five plugins inherited from #5387, whose versions main has since
passed; they are renumbered when main merges into the stack.
- Pinned ruff: `check` and `format --check` clean.

## Related

- #5387 is the base, and #5371 below it.
- #5465 files future drift as work items; dismissals here are what keep
that intake from repeating false positives.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

No related issue: operator decisions Q5 and Q11 from the 2026-09-29
native-surfaces interview (follow-up to #5371).

## Summary

Nothing re-ran the inventory or the overlap detector when Claude Code
shipped a release. Drift was found only by hand: new surfaces, renamed
or removed ones, invocability changes, and decision rows whose recheck
trigger had fired.

Stacked on #5371; merge that first.

## Fix

- **`/claude-ops:changelog apply` Phase 7, native-surface drift**
(`context/native-drift.md`) runs:
  - `inventory.py --self-check`
  - a full `--binary-only --docs` extraction
  - `overlap.py detect` and `overlap.py self-check`
- `native_drift.py summarize`, then `diff` against the last good
summary. A broken extraction never becomes the baseline.
- **Report:** surfaces added, removed, renamed (by alias or description
similarity) and reclassified; invocability and marker changes; docs
cross-check changes; new overlap candidates; fired store triggers.
- **Work items are filed through `/work-items:track add`** (raw intake,
`needs-triage`), one per:
  - new candidate with no store row;
  - store row whose trigger fired;
- revalidation proposal: the CLI is past `VALIDATED_AGAINST` with every
lane ok and no surface change;
  - degraded or broken inventory.
- **Dedupe:** each item carries a
`native-drift:<kind>:<surface>:<component>` key. An open item with the
key is skipped, and a candidate closed as not planned counts as
dismissed.
- **Approval:** interactive runs confirm the batch once; unattended
runs, declared by the caller, file directly.
- **Dynamic:** no surface names are hard-coded.
- `claude-ops` 0.66.0.

## Verification

- `native_drift.test.sh`: 23 cases OK.
- `changelog-status.test.sh`: 70/70.
- `overlap.test.sh`: 134 OK. `test_inventory.py`: OK.
- `check-changed-skills.sh origin/main`: 5 skills, 0 failed. The three
warnings are on lines this PR does not touch.
- `check-changelog-parity.sh`: `--check`, `--check-order`, `--check-bump
origin/main` and `--check-preserved origin/main` all pass.
- Pinned ruff: `check` and `format --check` clean. markdownlint: 0
issues.
- **Live run on 2.1.285** (validated 2.1.284, every lane ok, identical
surfaces): the revalidate path. It also flagged six store rows whose
markers moved. Four are already corrected in #5387; the two `design`
rows move to `suggest` in the planned description sweep.

## Related

- #5371 is the base. #5387 corrects the four marker rows.
- The `native-drift` label is managed as code in github-iac; a follow-up
adds it. Until then items file without it, and dedupe does not depend on
the label.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

…request descriptions (#5503)

No related issue: sweep unit 1 of the native-reference
description-phrase sweep approved in the 2026-09-29 native-surfaces
interview (Q4).

## Summary

The native-surface store records four `route` verdicts for
source-control whose routing clause lived only in each skill's Boundary
section. A body loads only on invocation, so the model picking between
our skill and the native one never saw it. A skill's description is what
the model reads when choosing a skill.

## Fix

- **`commit`:** a front-loaded, presence-gated clause for the bundled
`commit` skill and the built-in `/commit-push-pr` command.
- **`pull-request`:** a front-loaded, presence-gated clause for the
bundled `pr` skill and `/commit-push-pr`.
- **Store:** the four rows' `baked.description_phrase` flags are set,
and `docs/native-surfaces.md` is regenerated.
- **Adopters table:** the native-references Adopters table no longer
says source-control has no phrase.
- source-control 0.62.30.

Store rows gated by this change, each `complementary`, `route`, observed
by extraction against Claude Code 2.1.284:

| Native surface | Component |
|---|---|
| bundled `commit` | source-control:commit |
| built-in `/commit-push-pr` | source-control:commit |
| bundled `pr` | source-control:pull-request |
| built-in `/commit-push-pr` | source-control:pull-request |

**Not baked:** the `/autofix-pr` rows. They are `suggest` rows on a
surface the model cannot invoke. The operator ruled they get no phrase,
and the convention forbids one on that combination; their Boundary
sections already offer the command to the person.

## Verification

- `overlap.py self-check`: degraded, on the 2 documented advisories
only. `generate --check`: in sync.
- `test_overlap.py`: 172 tests OK.
- `check-changed-skills.sh origin/main`: 0 failed.
- `validate-plugin-contracts.mjs`: 0 warnings.
- `check-changelog-parity.sh`: all four modes pass.
- `check-spoke-plugin-root.sh`, typos and the ai-slop report: all clean.
- Description lengths: 654/1536 for `commit`, 659/1536 for
`pull-request`.

## Related

- #5387 recorded these verdicts and their Boundary sections.
- Sweep contract: one plugin per PR, each merged before the next unit
starts (`audit-native-overlap/SKILL.md`).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>